home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 1 / QRZ Ham Radio Callsign Database - December 1993.iso / unix / readme < prev    next >
Text File  |  1993-09-21  |  2KB  |  48 lines
  1.  
  2. The executable programs in this directory were created on a Sun Sparcstation
  3. running SunOS 4.1.3.  The code is fairly generic and should compile on a
  4. variety of UNIX machines.
  5.  
  6. Programs and files:
  7.  
  8.     090993.cbk - The FCC Callsign Database
  9.  
  10.     call - A unix-style command line program which looks up callsigns
  11.         or names
  12.  
  13.     nucall - A login-style callbook server program.
  14.  
  15.     mknlist - creates an unsorted index of all the lastname,firstname
  16.         combinations in the database.  The database is first
  17.         created using mknlist, and then 'nsort' is run to sort
  18.         the data.  This is only done once.
  19.  
  20.     nsort - sorts the names index created by mknlist (see above)
  21.  
  22.     pick - a test program used to select every n'th callsign in the
  23.         database.  During testing, the list created by 'pick'
  24.         was fed to the 'call' program to test its accuracy.
  25.  
  26.     cblib.a - a library of data manipulation functions used by
  27.         both 'call' and 'nucall'
  28.  
  29.     welcome.cbk - a text file which displayed by nucall at signon.
  30.  
  31.     call.log - a logon record of all who use 'nucall'
  32.  
  33.  
  34. Programming Notes:
  35.  
  36. This software was written and compiled under SunOS 4.1.3 and under
  37. Solaris 2.2.  The code makes use of the mmap() system call, which is
  38. available under most systems using BSD4.3 versions of UNIX.  For those
  39. systems not supporting the mmap system call, the user will have to
  40. create a workaround.
  41.  
  42. The strategy for a workaround consists of malloc'ing a large area of
  43. memory and then reading the entire (mmap'ed) file into it.  Then,
  44. the starting address of the malloc'ed area is used in the same way
  45. as the pointer returned by mmap().
  46.  
  47.  
  48.